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PROCEDE DE REALISATION B'UNE CHAINE DOCUMENT AIRE ET DE 
SA MISE A JOUR A PARTIR D'UN MODELE STRUCTURE 

La presente invention se rapporte a un precede de realisation d'une chaine 
5 documentaire et de sa mise a jour a partir d'un modele structure. 

II existe de nombreux generateurs automatiques de documentations a partir 
d'un modele structure, mais ils sont trop rigides du point de vue de Porganisation du 
document qu'ils creent, et ils ne permettent pas de realiser une mise a jour 
automatique du document suite a des modifications du modele. Une telle 
10 automatisation pourrait simplifier enormement la tache de Poperateur qui en est 
charge et lui faire gagner beaucoup de temps, car la mise a jour manuelle d'une 
documentation generee a partir d'un modele structure pent etre tres longue et 
fastidieuse, en particulier lorsque ce modele est complexe et volumineux. 

La presente invention a pour objet un precede de realisation d'une chaine 
15 documentaire a partir d'un modele structure, permettant d' organiser le document 
qu'il produit de n'importe quelle fa?on, et permettant de realiser sa mise a jour 
automatiquement 

Le precede conforme a P invention est caracterise en ce qu'il comporte les 
etapes suivantes : on part d'un modele structure dont on extrait des fragments 

20 documentaires pertinents, on architecture ensuite le document final en format 
traitement de texte en prelevant parmi ces fragments ceux necessaires et en les 
rangeant comme desire. On etablit ainsi pour chacun des fragments generes puis 
inseres un lien dynamique entre son emplacement dans la documentation et son 
fichier physique issu de la generation automatique. 

25 Selon une caracteristique de P invention, on peut utiliser similairement 

Poutil « RHAPSODY-DOC » avec « DOORS » pour la generation des fragments 
documentaires traitant de P information autour des exigences, puis la combinaison de 
« RHAPSODY-DOC » avec un traitement de textes pour inserer ces fragments 
DOORS et architecturer son document final. 

30 Dans la suite du document on appellera, pour plus de commodity « fragments 

documentaires exigence » les fragments documentaires issus de DOORS et 
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PROCEDE DE REALISATION D'UNE CHAINE DOCUMENT AIRE ET DE 
SA MISE A JOUR A PARTIR D'UN MODELE STRUCTURE 

La presente invention se rapporte a un procede de realisation d'une chaine 
docrimentaire et de sa mise a jour a partir d'un modele structure. 

II existe de nonibreux generateurs automatiques de documentations a partir 
d'un modele structure, mais ils sont trop rigides du point de vue de 1' organisation du 
document qu'ils creent, et ils ne permettent pas de realiser une mise a jour 
automatique du document suite a des modifications du modele. Une telle 
automatisation pourrait simplifier enormement la tache de l'operateur qui en est 
charge et lui faire gagner beaucoup de temps, car la mise a jour manuelle d'une 
documentation generee a partir d'un modele structure peut etre tres longue et 
fastidieuse, en particulier lorsque ce modele est complexe et volumineux. 

La presente invention a pour objet un procede de realisation d'une chaine 
documentaire a partir d'un modele structure, permettant d'organiser le document 
qu'il produit de n'importe quelle facon, et permettant de realiser sa mise a jour 
automati quement. 

Le procede conforme a 1 'invention est caracterise en ce qu'il comporte les 
etapes suivantes : on part d'un modele structure dont on extrait des fragments 
20 documentaires pertinents, on architecture ensuite le document final en format 
traitement de texte en prelevant parmi ces fragments ceux necessaires et en les 
rangeant comme desir6. On etablit ainsi pour chacun des fragments generes puis 
inseres un lien dynamique entre son emplacement dans la documentation et son 
fichier physique issu de la generation automatique. 

. Selon une caracteristique de l'invention, on peut utiliser similairement 
l'outil « RHAPSODY-DOC » avec « DOORS » pour la generation des fragments 
documentaires traitant de 1'information autour des exigences, puis la combinaison de 
« RHAPSODY-JDOC » avec un traitement de textes pour inserer ces fragments 
DOORS et architecturer son document final. 

Dans la suite du document on appellera, pour plus de commodity « fragments 
documentaires exigence » les fragments documentaires issus de DOORS et 
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« fragments documentaires du modele » les fragments documentaires issus du 
modele structure. Par « fragment documentaire », de maniere generate, on entendra 
fragment des deux types melanges. 

La presente invention sera mieux comprise a la lecture de la description 
detaillee d'un mode de mise en oeuvre, pris a titre d'exemple non limitatif et illustre 
par le dessin annexe, sur lequel : 

- la figure 1 est une interface graphique d'une macro d'un traitement de textes 
montrant Parborescence des fragments documentaires apres la phase de 
generation des fragments du procede de P invention, 

- la figure 2 est une vue de P interface de la figure 1 montrant la fonctionnalite 
de filtre des fragments documentaires facilitant la recherche de fragments, 

- la figure 3 est une vue d'une interface graphique de l'outil « DOORS » dans 
laquelle sont definies les informations d'exigences que Ton veut transferer 
dans la documentation, selon une variante du procede de P invention, 

- les figures 4, 5 et 6 sont des vues successives d'une interface graphique 
d'un traitement de textes « WORD » dans lequel on definit le « template » 
(canevas) du fragment documentaire, a savoir la disposition des informations 
d'exigences DOORS, telle qu'on veut la voir repartie dans les fragments 
documentaires exigences, apres generation documentaire, conformement au 
procede de P invention, 

- la figure 7 est une vue d'un des fragments documentaires exigence issu de la 
generation documentaire et prenant en compte le canevas defini figures 4, 5 et 
6 et les donnees exigences DOORS de la figure 3 , et 

- la figure 8 est une vue d c une interface graphique de Poutil « DOORS >> mise 
en ceuvre par le procede de Pinvention pour lancer la generation de fragments 
documentaires exigences depuis DOORS. 

Le procede de Pinvention permet de generer facilement une documentation, 
par exemple au format WORD ou RTF, a partir de fragments documentaires 
provenant d'un modele UML (informations d 5 architecture du logiciel) et, de fa<?on 
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« fragments documentaires du modele » les fragments documentaires issus du 
modele structure. Par « fragment documentaire », de maniere generate, on entendra 
fragment des deux types melanges. 

La presente invention sera mieux comprise a la lecture de la description 
5 detaillee d'un mode de mise en oeuvre, pris a titre d'exemple non limitatif et illustre 
par le dessin annexe, sur lequel : 

- la figure 1 est une interface graphique d'une macro d'un traitement 
de textes montrant Parborescence des fragments documentaires apres 
la phase de generation des fragments du procede de 1' invention, 

10 - la figure 2 est une vue de Pinterface de la figure 1 montrant la 

fonctionnalite de filtre des fragments documentaires facilitant la 
recherche de fragments, 

- la figure 3 est une vue d'une interface graphique de Poutil 
« DOORS » dans laquelle sont definies les informations d'exigences 

15 que Ton veut transferer dans la documentation, selon une variante du 

procede de V invention, 

- les figures 4, 5 et 6 sont des vues successives d'une interface 
graphique d'un traitement de textes « WORD » dans lequel on definit 
le canevas du fragment documentaire, a savoir la disposition des 

20 informations d' exigences DOORS, telle qu'on veut la voir repartie 

dans les fragments documentaires exigences, apres generation 
documentaire, conformement au procede de Pinvention, 

- la figure 7 est une vue d'un des fragments documentaires exigence 
issu de la generation documentaire et prenant en compte le canevas 

25 defini figures 4, 5 et 6 et les donnees exigences DOORS de la figure 3 

, et 

- la figure 8 est une vue d'une interface graphique de Poutil 
« DOORS » mise en oeuvre par le procede de P invention pour lancer 
la generation de fragments documentaires exigences depuis DOORS. 
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optionnelle, d'un module « DOORS » (information de tracabilite des exigences) qui 
est un outil de gestion d' exigences de la societe TELELOGIC. 

La documentation finale obtenue comprend des parties issues de la generation 
automatique, mais aussi des parties textuelles (texte libre manuel) incluses entre les 
fragments generes. Une macro WORD permet de lancer une interface graphique qui 
organise tous les fragments documentaires generes et permet de selectionner l'un 
d'eux, puis de 1'inclure tres facilement dans un document au format WORD (voir 
figure 1). 

Dans le detail, le precede de l'invention se deroule de la facon suivante : 

1) L'utilisateur se sert d'un outil de moderation tel que «RHAPSODY» de la 
societe I-LOGIX. II charge sous RHAPSODY le modele duquel il desire tirer une 
documentation (dans l'exemple decrit ci-dessous, ce modele s'appelle tout 
simplement « modele »). II lance « RHAPSODY-DOC » a travers le menu 
« TOOLS » de RHAPSODY. II genere a I'aide de RHAPSODY-DOC, de facon 
connue en soi, les fragments documentaires du modele qu'il desire inclure dans la 
documentation finale. 

2) (Etape optionnelle - voir descriptif detaille de la variante de precede ci-dessous) 
L'utilisateur se sert d'un outil de gestion des exigences tel que «DOORS» de la 
societe TELELOGIC. II charge sous DOORS le module duquel il desire tirer de 
1' information pour la documentation finale (dans l'exemple decrit ci-dessous, ce 
module s'appelle tout simplement « module »). II lance « RHAPSODY-DOC » a 
travers le menu « DOORS Customs » de DOORS. II genere a l'aide de 
RHAPSODY-DOC, de facon connue en soi, les fragments documentaires des 
exigences qu'il desire inclure dans la documentation finale. 

3) Puis, il ouvre un document vide (ou un document type de son referentiel de 
documentation) d'un traitement de textes, qui est « WORD » dans le cas present. 

4) L'utilisateur clique sur le bouton «Inserer un fragment » de la barre d'outils 
WORD relative a RHAPSODY-DOC pour lancer la macro WORD qui ouvre une 
fenetre « Insert documentation fragment ». L'utilisateur selectionne dans cette 
interface le modele dans lequel se trouve son information documentaire dans la boite 
a options « Model ». Comme precise ci-dessus, ce modele s'appelle « modele ». II 
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Le procede de P invention permet de generer facilement une documentation, 
par exemple au format WORD on RTF, a partir de fragments document aires 
provenant d'un modele UML (informations d 5 architecture du logiciel) et, de facpon 
optionnelle, d'un module « DOORS » (information de tragabilite des exigences) qui 
est un outil de gestion d' exigences de la societe TELELOGIC. 

La documentation finale obtenue comprend des parties issues de la generation 
automatique, mais aussi des parties textuelles (texte libre manuel) incluses entre les 
fragments generes. Une macro WORD permet de lancer une interface graphique qui 
organise tous les fragments documentaires generes et permet de selectionner Tun 
d'eux, puis de rinclure tres facilement dans un document au format WORD (voir 
figure 1). 

Dans le detail, le procede de P invention se deroule de la fa?on suivante : 

1) L'utilisateur se sert d'un outil de modelisation tel que «RHAPSODY» de la 
societe I-LOGIX. II charge sous RHAPSODY le modele duquel il desire tirer une 
documentation (dans P exemple decrit ci~dessous, ce modele s'appelle tout 
simplement « modele »). II lance « RHAPSODY-DOC » a travers le menu 
« TOOLS » de RHAPSODY. II genere a Paide de RHAPSODY-DOC, de fa9on 
connue en soi, les fragments documentaires du modele qu'il desire inclure dans la 
documentation finale. 

2) (Etape optionnelle - voir descriptif detaille de la variante de procede ci-dessous) 
L'utilisateur se sert d'un outil de gestion des exigences tel que «DOORS» de la 
societe TELELOGIC. II charge sous DOORS le module duquel il desire tirer de 
1 'information pour la documentation finale (dans P exemple decrit ci-dessous, ce 
module s'appelle tout simplement « module »). II lance « RHAPSODY-DOC » a 
travers le menu « DOORS Customs » de DOORS. II genere a Paide de 
RHAPSODY-DOC, de fa?on connue en soi, les fragments documentaires des 
exigences qu ? i] desire inclure dans la documentation finale. 

3) Puis, il ouvre un document vide (ou un document type de son referentiel de 
documentation) d'un traitement de textes, qui est « WORD » dans le cas present. 

4) L'utilisateur clique sur le bouton « Inserer un fragment » de la barre d'outils 
WORD relative a RHAPSODY-DOC pour lancer la macro WORD qui ouvre une 
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selections ensuite son generateur de fragments documentaires dans la boite a 
options « Documentation Project ». Dans l'exemple decrit id, il s'agit de 
RHAPSODY-DOC. Apparait alors une arborescence contenant tons les fragments 
documentaires generes prealablement (voir figure 1). 
5 5) Puis, il selections un fragment dans 1'arbre dont la structure arborescente reprend 
l'architecture des paquetages du modele UML de depart. II lui reste a positionner le 
curseur dans le document WORD a 1'endroit ou le fragment doit etre insere, puis a 
cliquer sur le bouton «Inserer», qui se trouve dans le bandeau inferieur de 
P interface. 

10 Le nombre de fragments documentaires peut devenir tres important. Pour 

faciliter la recherche du fragment a inserer, 1'utilisateur a la possibility de filtrer les 
fragments proposes dans la boite a options « Fragments » de I'interface graphique, 
comme represent en figure 2. Ce filtrage se fait a partir du type de fragments 
generes. Dans l'exemple de la figure 2, le nom des types de fragments «Nom et 
1 5 description » est mis en inversion video par le passage du curseur sur leur nom, et il 
suffit alors de cliquer sur ce nom pour realiser le filtrage desire. L' arborescence 
affichee ne contient alors plus que les fragments du type desire, limitant done de 
beaucoup leur nombre et accelerant la recherche et la selection du fragment souhaite. 

Pour effectuer la mise a jour d'un document existant, 1'utilisateur, apres avoir 
fait des modifications dans son modele UML, lance le programme de generation 
documentaire depuis RHAPSODY et, de facon optionnelle, de DOORS pour 
remettre a jour sa base de fragments documentaires. Ensuite, il utilise la fonction 
"Update" de la macro WORD. Tous les fragments precedemment inseres seront 
automatiquement mis a jour et au bon endroit dans le document final! On remarquera 
que si de nouveaux fragments sont necessaires, ils devront 6tre inseres 
manuellement. 

Selon une variante du procede de l'invention, il est possible de recuperer de 
l'information issue de 1'outil « DOORS » precite. II est genere pour chaque exigence 
d'un module DOORS un fragment documentaire exigence que l'on peut ensuite ' 
30 inserer a 1'endroit desire dans le document final. 
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fenetre « Insert documentation fragment ». L'utilisateur selectionne dans cette 
interface le raodele dans lequel se trouve son information documentaire dans la boite 
a options « Modele ». Comme precise ci-dessus, ce modele s'appelle « modele ». II 
selectionne ensuite son generateur de fragments documentaires dans la boite a 
5 options « Documentation Projet». Dans Pexemple decrit ici, il s'agit de 
RHAPSODY-DOC. Apparait alors une, arborescence contenant tous les fragments 
documentaires generes prealablement (voir figure 1). 

5) Puis, il selectionne un fragment dans Parbre dont la structure arborescente reprend 
P architecture des paquetages du modele UML de depart. II lui reste a positionner le 
10 curseur dans le document WORD a Pendroit ou le fragment doit etre insere, puis a 
cliquer sur le bouton « Inserer », qui se trouve dans le bandeau inferieur de 
Pinterface. 

Le nombre de fragments documentaires peut devenir tres important. Pour 
faciliter la recherche du fragment a inserer, l'utilisateur a la possibilite de filtrer les 

15 fragments proposes dans la boite a options « Fragments » de V interface graphique, 
comme represents en figxxre 2. Ce filtrage se fait a partir du type de fragments 
generes. Dans Pexemple de la figure 2, le nom des types de fragments « Nom et 
description » est mis en inversion video par le passage du curseur sur leur nom, et il 
suffit alors de cliquer sur ce nom pour realiser le filtrage desire. L' arborescence 

20 affichee ne contient alors plus que les fragments du type desire, limitant done de 
beaucoup leur nombre et accelerant la recherche et la selection du fragment souhaxte. 

Pour effectuer la mise a jour d'un document existant, Tutilisateur, apres avoir 
fait des modifications dans son modele UML, lance le programme de generation 
documentaire depuis RHAPSODY et, de fa?on optionnelle, de DOORS pour 

25 remettre a jour sa base de fragments documentaires. Ensuite, il utilise la fonction 
"Mise a jour" de la macro WORD. Tous les fragments precedemment inseres seront 
automatiquement mis a jour et au bon endroit dans le document final. On remarquera 
que si de nouveaux fragments sont necessaires, ils devront etre inseres 
manuellement. 

30 Selon une variante du procede de 1 'invention, il est possible de recuperer de 

Pinformation issue de Poutil « DOORS » precite, II est genere pour chaque exigence 
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La generation de fragments documentaires s'effectue a partir d'une vue 
DOORS d'un module ou 1'on definit l'ensemble des informations que Ton souhaite 
faire apparaitre dans le document WORD. L'utilisateur definit la maniere dont il 
souhaite representer ces informations dans WORD a l'aide de « templates » WORD 
(des fichiers « .dot » de modeles de presentation) et de signets WORD. Dans ce 
template, on construit la representation generique que l'on souhaite donner aux 
objets contenus dans la vue associee. Une vue DOORS est composee de colonnes, 
chaque colonne ayant un titre. Le « mapping » (la liaison) entre une vue DOORS 
(interface graphique de l'outil DOORS) et le template WORD associe est effectue au 
travers de signets, chaque signet portant le nom de la colonne qu'il represente. 

On a represents en figure 3 une vue DOORS. Sur cette vue, il y a quatre 
colonnes, respectivement intitulees « PUID » (identite des objets ) , « Name » (noms 
des objets), « Status » (etat des objets), et « Risk Impact » (impact sur les differents 
elements du modele considere ). Les objets UML apparaissant sur la vue et sur 
lesquels sont posees des exigences sont respectivement references OBJ1 a OBJ4. 
L'etat des trois premiers est « Accepted » (accepte), alors que celui du dernier est 
«In negociation» (en cours de traitement). Leurs impacts respectifs sont: 
« Performance », « Operational Use » (utilisation operationnelle), « Organization » 
(organisation) et « Technology » (technologie). 

L'utilisateur ouvre un fichier WORD et l'enregistre sous un nom quelconque 
avec l'extension « .dot », par exemple « My Template.dot », comme represente en 
figure 4. Puis, il definit dans ce fichier l'aspect general qu'il souhaite donner aux 
objets contenus dans la vue DOORS (un tableau a deux lignes et deux colonnes, 
comme represente en figure 4). Ensuite, il insere dans le document WORD un 
signet specifique pour chaque attribut DOORS qu'il souhaite extraire. II insere ce 
signet a l'endroit ou il desire voir apparaitre le contenu de 1'attribut considere pour 
chacune des exigences DOORS (par exemple 1'exigence [111] s'appliquant sur un 
objet UML, qui est alors OBJ1) 

On a represente en figures 5 a 7 un exemple d'insertion de la colonne « Risk 
Impact » pour l'objet OBJ2. En figure 5, on a represente comment l'utilisateur 
designe le point d'insertion d'un signet. En figure 6, l'utilisateur choisit le nom du 



regue le 29/06/04 




d'un module DOORS un fragment documentaire exigence que Ton peut ensuite 
inserer a l'endroit desire dans le document final. 

La generation de fragments documentaires s'effectue a partir d'une vue 
DOORS d'un module ou Ton definit l'ensemble des informations que 1'on souhaite 
5 faire apparaitre dans le document WORD. L'utilisateur definit la maniere dont il 
souhaite representer ces informations dans WORD a l'aide de « canevas » WORD 
(des fichiers « .dot » de modeles de presentation) et de signets WORD. Dans ce 
template, on construit la representation generique que l'on souhaite donner aux 
objets contenus dans la vue associee. Une vue DOORS est composee de colonnes, 
10 chaque colonne ayant un titre. Le « mapping » (la liaison) entre une vue DOORS 
(interface graphique de l'outil DOORS) et le canevas WORD associe est effectue au 
travers de signets, chaque signet portant le nom de la colonne qu'il represente. 

On a represente en figure 3 une vue DOORS. Sur cette vue, il y a quatre 
colonnes, respectivement intitulees « PUTD » (identite des objets ) , « Nom » (noms 
15 des objets), « Statut » (etat des objets), et « Risque Impact » (impact sur les 
differents elements du modele considere). Les objets UML apparaissant sur la vue 
et sur lesquels sont posees des exigences sont respectivement references OBJ1 a 
OBJ4. L'etat des trois premiers est « Accepte », alors que celui du dernier est « En 
negotiation » (en cours de traitement). Leurs impacts respectifs sont: 
20 « Performance », « Utilisation operationnelle », « Organisation » et « Technologie ». 

L'utilisateur ouvre un fichier WORD et 1'enregistre sous un nom quelconque 
avec 1'extension « .dot », par exemple « Mon canevas.dot », comme represente en 
figure 4. Puis, il definit dans ce fichier l'aspect general qu'il souhaite donner aux 
objets contenus dans la vue DOORS (un tableau a deux lignes et deux colonnes, 
25 comme represente en figure 4). Ensuite, il insere dans le document WORD un 
signet specifique pour chaque attribut DOORS qu'il souhaite extraire. II insere ce 
signet a l'endroit ou il desire voir apparaitre le contenu de 1'attribut considere pour 
chacune des exigences DOORS (par exemple l'exigence [1 1 1] s'appliquant sur un 
objet UML, qui est alors OBJ1) 

On a represente en figures 5 a 7 un exemple d'insertion de la colonne 
« Risque Impact » pour l'objet OBJ2. En figure 5, on a represente comment 
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signet (« Risk impact » dans le cas present) dans la fenetre deroulante d'insertion de 
signets de WORD. En procedant de la meme maniere pour les autres colonnes de la 
vue DOORS, l'utilisateur obtient un canevas «My Template.dot » qui, apres 
generation a partir de DOORS, donne quatre fragments documentaires (un par 
exigence) contenant les informations specifies (celui genere pour 1'exigence [222] 
appliquee sur l'objet UML OBJ2, est represents en figure 7). 

La generation de fragments documentaires via « RHAPSODY-DOC 
GENERATION» ne fonctionne que dans le contexte ou des exigences identifiees 
dans un modele Rhapsody ont ete importers sous DOORS en utilisant la fonction 
d'import de « DOORS Custom ». Dans ce cas, le module d'exigence cree suite a cet 
import est correctement implement pour la generation documentaire. A partir de ce 
module, « RHAPSODY-DOC » peut etre declenche depuis le menu « DOORS 
Custom » de DOORS. L'interface representee en figure 8 est alors lancee. 

Le champ "RHAPSODY-DOC fragmentjist Path" permet de specifier le 
chemin du fichier utilise par RHAPSODY-DOC pour lister les fragments 
documentaires generes depuis RHAPSODY ou DOORS. En general, ce fichier se 
trouve sous le repertoire « generated » du repertoire d'installation de RHAPSODY- 
DOC. 

Le champ "Generation Destination Folder" permet de specifier le chemin du 
repertoire ou seront generes les fragments documentaires. Si le chemin specifie n'a . 
pas encore ete cree, il le sera lors de l'export. Le champ "Generation Template" 
permet de specifier le template WORD (du style du fichier « My template.dot ») a 
utiliser pour la generation des fragments documentaires. Le champ "Generation 
Options" propose deux types de generation possibles : 

La premiere, « One Fragment per Requirement » (representee sur la figure 8), 
permet de generer un fragment documentaire par exigence, 

La seconde, « One Fragment per UML Container » (non representee sur la 
figure 8), permet de generer un fragment par element UML contenant des exigences 
dans le modele. Chaque fragment genere contient la Iiste des exigences contenues 
dans ces elements UML. 
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l'utilisateur designe le point d' insertion d'un signet. En figure 6, l'utilisateur choisit 
le nom du signet (« Risque impact » dans le cas present) dans la fenetre deroulante 
d'insertion de signets de WORD. En procedant de la rneme maniere pour les autres 
colonnes de la vue DOORS, 1'utilisateur obtient un canevas « Mon canevas.dot » 
5 qui, apres generation a partir de DOORS, donne quatre fragments docmnentaires (un 
par exigence) contenant les informations specifiees (celui genere pour 1' exigence 
[222] appfiquee sur l'objet UML OB.T2, est represente en figure 7). 

La generation de fragments documentaires via « RHAPSODY-DOC 
GENERATION)) ne fonctionne que dans le contexte ou des exigences identifies 
10 dans un modele Rhapsody ont ete importees sous DOORS en utilisant la fonction 
d'import de « DOORS Custom ». Dans ce cas, le module d'exigence cree suite a cet 
import est correctement implemente pour la generation documentaire. A partir de ce 
module, « RHAPSODY-DOC » peut etre declenche depuis le menu « DOORS 
Custom » de DOORS. L'interface representee en figure 8 est alors lancee. 
15 Le champ "RHAPSODY-DOC fragmentjist Path" permet de specifier le 

chemin du fichier utilise par RPIAPSODY-DOC pour lister les fragments 
documentaires generes depuis RHAPSODY ou DOORS. En general, ce fichier se 
trouve sous le repertoire « generated » du repertoire d'installation de RHAPSODY- 
DOC. 

-° Le champ « Dossier Destination de Generation » permet de specifier le 

chemin du repertoire ou seront generes les fragments documentaires. Si le chemin 
specifie n'a pas encore ete cree, il le sera lors de l'export. Le champ "Generation 
Canevas" permet de specifier le template WORD (du style du fichier « Mon 
canevas.dot ») a utiliser pour la generation des fragments documentaires. Le champ 

15 "Options de generation" propose deux types de generation possibles : 

La premiere, « Un Fragment par Exigence » (representee sur la figure 8), 
permet de generer un fragment documentaire par exigence, 

La seconde, « Un Fragment par Container UML » (non representee sur la 
figure 8), permet de generer un fragment par element UML contenant des exigences 

i0 dans le modele. Chaque fragment genere contient la liste des exigences contenues 
dans ces elements UML. 
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Une fois la generation terminee, il suffit de retourner sous WORD et d'utiliser la 
macro WORD de RHAPSODY-DOC. Les fragments correspondant au modele UML 
concerne venant de DOORS sont classes dans la categorie « Documentation 
Project » de RHAPSODY et DOORS. Cette categorie ne contient que les fragments 
documentaires exigences, mais 1'arborescence dans laquelle elles sont placees est la 
m&ne que celle qui se trouve dans le modele UML. 
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Une fois la generation terminee, il suffit de retourner sous WORD et d'utiliser la 
macro WORD de RHAPSODY-DOC. Les fragments correspondant au modele UML 
concerne venant de DOORS sont classes dans la categorie « Projet Documentation » 
de RHAPSODY et DOORS. Cette categorie ne contient que les fragments 
5 documentaires exigences, mais l'arborescence dans laquelle elles sont placees est la 
meme que celle qui se trouve dans le modele UML. 
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REVINDICATIONS 



1. Procede de realisation d'une chaine documentaire a partir d'un modele 
structure , caracterise en ce qu'il comporte les etapes suivantes : on part d'un modele 
5 structure dont on extrait des fragments pertinents, on architecture ensuite le 
document final en format traitement de texte en prelevant parmi ces fragments ceux 
necessaires et en les rangeant comme desire. On etablit ainsi pour chacun des 
fragments generes puis inseres un lien dynamique entre son emplacement dans la 
documentation et son fichier physique issu de la generation automatique. 
10 2 - Procede selon la revendication 1, caracterise en ce que le modele 

structure est un modele UML. 

3. Procede selon la revendication 1 ou 2, caracterise en ce que l'on 
effectue la mise a jour de la documentation a l'aide des liens dynamiques. 

4. Procede selon 1'une des revendications precedentes, caracterise en 
15 ce que le modele est realise a l'aide de l'outil « RHAPSODY » et que l'on utilise 

« RHAPSODY-DOC » pour generer les fragments documentaires que l'on desire 
inclure dans la documentation finale. 

5. Procede selon la revendication 4, caracterise en ce que les 
fragments documentaires generes sont inseres dans un document ouvert dans un 

20 traitement de textes. 

6. Procede selon la revendication 1, 2 ou 3, caracterise en ce que l'on 
utilise l'outil « RHAPSODY-DOC » avec « DOORS » pour la generation des 
fragments documentaires traitant de 1 'information autour des exigences, puis la 
combinaison de « RHAPSODY-DOC » avec un traitement de textes pour inserer ces 

25 fragments DOORS et architecturer son document final. 

7. Procede selon la revendication 1, 2 ou 3, caracterise en ce que l'on 
utilise l'outil « RHAPSODY-DOC » avec « DOORS » et un traitement de textes 
pour la generation documentaire. 
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REVENDICATIONS 

1. Procede de realisation d'une chaine documentaire a partir d'un modele 
structure , caracterise en ce qu'il comporte les etapes suivantes : 
5 - chargement d'un modele structure dans un outil de modelisation ; 

- generation de fragments documentaires du modele ; 

- selection du modele comport ant P information documentaire et du 
generateur de fragments documentaires ; 

- insertion des fragments documentaires generes dans la structure 
1 0 documentaire de la chaine documentaire. 

2. Procede selon la revendication 1 ? caracterise en ce que le modele 
structure est un modele UML. 

3. Procede selon la revendication 1 ou 2 5 caracterise en ce que Pon 
effectue la mise a jour de la documentation a l'aide de lien dynamiques etablis pour 

15 cliaque fragment genere entre son emplacement dans la chaine documentaire et son 
fichier physique issu de la generation documentaire automatiqiie. 

4. Procede selon Pune des revendications precedentes, caracterise en 
ce que le modele est realise a Paide de Poutil « RHAPSODY » et que Pon utilise 
« RHAPSODY-DOC » pour generer les fragments documentaires que Pon desire 

20 inclure dans la documentation finale. 

5. Procede selon la revendication 4 5 caracterise en ce que les 
fragments documentaires generes sont inseres dans un document ouvert dans un 
traitement de textes. 

6. Procede selon la revendication 1, 2 ou 3, caracterise en ce que Pon 
25 utilise Poutil « RHAPSODY-DOC » avec. « DOORS » pour la generation des 

fragments documentaires traitant de P information autour des exigences, puis la 
combinaison de « RHAPSODY-DOC » avec un traitement de textes pour inserer ces 
fragments DOORS et architecturer son document final. 

7. Procede selon la revendication 1, 2 ou 3, caracterise en ce que Pon 
30 utilise Poutil « RHAPSODY-DOC » avec « DOORS » et un traitement de textes 

pour la generation documentaire. 
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8. Procede selon Pune des revendications precedentes, caracterise pax 
le fait que la documentation finale comporte du texte libre manual inclus entre les 
fragments generes. 

9. Procede selon Pune des revendications precedentes, caracterise par 
le fait que Ton filtre les types de fragments generes avant leur insertion dans la 
chaine document aire. 
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